Manage external resources
CLEM.Activities.ResourceActivityManageExternal
Manages the external input and output of resources specified in a data reader

This activity allows you to provide resources external to the farm during the simulation. These resources are provided from a data file using a Resource data reader in the same way that crop and pasture production are provided to the model. The data file (Microsoft Excel spreadsheet or ASCII delimited text) specifies the month of provision as well as the resource applied to and whether it is an input to or output from the system. This activity can also include all financial considerations in making these transactions.
This activity does not currently support the following Resource Types as they require additional functionality to be identified or modified:

The following parameters are used to define this activity

This parameter points to one of the defined Resource data reader added to the simulation tree for this simulation. This entry is a drop down list of all available Resource data readers in the simulation. The data reader manages reading data from a formatted data file (Excel spreadsheet or ASCII delimited text file).

You can specify a bank account (Finance type) to include financial considerations when performing the management of external resources.
This parameter points to one of the defined Finance types in the Finance group of the Resources available for this simulation. This entry is a drop down list of available Finance types.

This is the default setting for the Bank account to use and will not include financial transactions, resource pricing and packet size in managing external resources

If you provide the name of a Finance type from the drop down list, this activity will use the packet size and price per packet of resources where provided to include the finance paid (inputs) and received (outputs).
Financial constraints will also produce limitations to how this activity can be performed.
See Resource pricing to learn how to set the packet size and pricing of a resource.

This parameter will determine what action is taken if there are insufficient resources to perform this activity.
You can report an error and stop the simulation, skip this activity or use the resources available. See What to do when resources are limiting

The following components will add additional functionality to this activity
This activity provides the following units for components: fixed, amount incoming, amount outgoing, dollar value incomingand dollar value outgoing

Any Activity fee will include financial costs based on any specified identifiers and units and may limit the outcomes if supported and OnPartialResourcesAvailableAction set to UseAvailableWithImplications

Any Labour requirement will include labour allocation to perform this activity based on any specified identifiers and units and may limit the outcomes if supported and OnPartialResourcesAvailableAction set to UseAvailableWithImplications

This activity respects all Timers allowing you to determine when it will occur. See Using timers

Manage external resource multiplier components can be added below this activity to provide an adjustment to the amount provided from the input file.

The following status values apply to this activity and are shown in Activities performed report:
![]() |
blank | The activity was not considered in this time-step |
![]() |
not needed | No resources were specified by the Resource data reader in this time-step |
![]() |
partial | Exchange of resources was limited by shortfalls in Finances and/or Labour |
![]() |
success | External resources were successfully added and/or removed in this time-step |
![]() |
warning | One or more resources provided by the Data Reader could not be identified (see Summary information) |

This activity is performed during the Get Resources Required event of the setup and time-step events. This is the standard, monthly clock event by which CLEM activities request resources and perform actions based on the resources provided, therefore this activity will compete with most activities in the time-step with their location in the simulation tree determining the order they are processed (this includes activities located on other CLEM and Market components). If this activity relies on another activity having been performed, or other activities rely on this activity in the time-step, ensure it has been performed in the correct order based on it's position in the simulation tree.
See also